home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Tools / lsof_3.37 / README < prev   
Encoding:
Text File  |  1995-08-01  |  9.0 KB  |  240 lines
  1.         lsof (LiSt Open Files) version 3
  2.             (revision 3.37)
  3.  
  4. ********************************************************************
  5. | The latest release of lsof is always available via anonymous ftp |
  6. | from vic.cc.purdue.edu.  Look in pub/tools/unix/lsof.            |
  7. ********************************************************************
  8.  
  9. Lsof version 3 lists open files for running Unix processes.  It is
  10. a descendent of ofiles, fstat, lsof version 1, and lsof version 2.
  11. It speaks the following Unix dialects:
  12.  
  13.     AIX 3.2.[45], 4.1, and        IBM RISC/System 6000
  14.         4.1.[12]
  15.     DC/OSx 1.1            Pyramid ES, Nile, and S series
  16.     EP/IX 2.1.1            CDC 4680
  17.     FreeBSD 1.1.5.1, 2.0, and    Intel-based systems
  18.         2.0.5
  19.     HP-UX 8.x, 9.x, and 10        HP
  20.     IRIX 4.0.5, 5.2, 5.3, and 6.0    SGI
  21.     Linux through 1.2.11        Intel-based systems
  22.     NetBSD 1.0 and 1.0A        Intel and SPARC-based systems
  23.     NEXTSTEP 2.1 and 3.[0123]    all NEXTSTEP architectures
  24.     Novell UnixWare 1.1, 1.1.1,    Intel-based systems
  25.         and 1.1.2
  26.     OSF/1 1.3, 2.0, 3.0, and 3.2    DEC Alpha
  27.     RISC/os 4.52            MIPS R2000-based systems
  28.     SCO OpenDesktop or OpenServer    Intel-based systems
  29.         1.1, 3.0, and 5.0
  30.     Sequent Dynix 3.0.12        Sequent Symmetry
  31.     Sequent PTX 2.1.[156] and    Sequent systems
  32.         4.0.[23]
  33.     Solaris 2.[1234]        Sun 4 and i86pc
  34.     SunOS 4.1.[1234]        Sun 3 and 4
  35.     Ultrix 2.2, 4.2, 4.3, and 4.4    DEC RISC and VAX
  36.     V/88 R32V3, R40V4.2, and    Motorola M88K
  37.         R40V4.3
  38.  
  39. (The pub/tools/unix/lsof/contrib directory on vic.cc.purdue.edu
  40. contains information on other ports.)
  41.  
  42. Version 3 of lsof is distributed as gzip'd and compressed tar archives
  43. in the files:
  44.  
  45.         pub/tools/unix/lsof/lsof.tar.gz
  46.     and
  47.         pub/tools/unix/lsof/lsof.tar.Z
  48.  
  49. These files are links to the current distribution, whose name
  50. includes the revision number:
  51.  
  52.         pub/tools/unix/lsof_<rev>_W.tar.gz
  53.     and
  54.         pub/tools/unix/lsof_<rev>_W.tar.Z
  55.     
  56. <rev> is the revision number -- e.g., 3.37.  The ``_W'' marks the
  57. tar file as a wrapper -- the source tar file is inside the wrapper.
  58. (A tar file with a ``.gz'' suffix is gzip'd; ``.Z'', compressed.)
  59. The wrapper method is used to join instruction and PGP certificate
  60. files with their source tar file.  The PGP certificate file
  61. authenticates the source tar file.
  62.  
  63. When the wrapper tar is gunzip'd or uncompressed, and its tar
  64. contents are extracted, three files are produced in the current
  65. directory where the extraction was performed:
  66.  
  67.     README.lsof_<rev>    contains instructions for the
  68.                 security-conscious on how to be
  69.                 sure that no one has tampered with
  70.                 the tar file.
  71.  
  72.     lsof_<rev>.tar        is a tar file, containing the lsof
  73.                 sources.  When extracted with tar
  74.                 it creates a subdirectory in the
  75.                 current directory where the extraction
  76.                 was performed, named lsof_<rev>.
  77.                 The lsof source files will be found in
  78.                 lsof_<rev>.
  79.  
  80.     lsof_<rev>.tar.asc    is a PGP certificate, authenticating
  81.                 the lsof_<rev>.tar file.  See the
  82.                 README.lsof_<rev> file for more
  83.                 information on PGP authentication of
  84.                 lsof_<rev>.tar.
  85.  
  86. If you've obtained this file and an lsof distribution from a mirror
  87. site, please be aware that THE LATEST VERSION OF LSOF IS AVAILABLE
  88. VIA ANONYMOUS FTP FROM VIC.CC.PURDUE.EDU (128.210.15.16) IN THE
  89. PUB/TOOLS/UNIX/LSOF DIRECTORY.
  90.  
  91. (If you need a copy of gunzip, look for it at prep.ai.mit.edu in
  92. pub/gnu.)
  93.  
  94. *  The June 30, 1995 revision (3.34) changes the offset display
  95.    to decimal when possible; corrects the output of inode field
  96.    output from signed to unsigned; documents the `*' prefix on the
  97.    inode number; and expands the INODE output field width in the
  98.    list_fields.{awk,perl} and list_NULf.perl5 scripts.
  99.  
  100. *  The July 9, 1995 revision (3.35) shortens the usage display
  101.    when argument errors are detected; adds support for Solaris
  102.    loopback files; contains Linux code to compare the system map
  103.    file to /proc/ksyms; adds dot-form names to host name cache.
  104.  
  105. *  The July 21, 1995 revision (3.36): provides a default name cache
  106.    size for dialects using a pointer-linked name cache when the
  107.    kernel's name cache size variable value is zero; removes the
  108.    use of the d_namlen struct dirent member from Linux when the
  109.    version is 1.2.10 or greater; supports FreeBSD 2.0.5; deletes
  110.    the previous operation of the -c, -d, -m, and -O options; replaces
  111.    the former -c option with the -m option; adds with the changed
  112.    -c option command name selection; relegates the previous action
  113.    of the -d option to the WARNDEVACCESS compile-time definition;
  114.    adds with the changed -d option file descriptor selection; adds
  115.    with the changed -O option a low overhead mode; adds with the
  116.    -r option a repeat mode.
  117.  
  118. *  The July 27, 1995 revision (3.37) revises option handling further:
  119.    the -f -F and -0 options are combined in one, -F; values for some
  120.    options (-F, -g, -r, and -S) are now optional, although some care
  121.    must be taken to insure that a following option is not mistaken for
  122.    a value.  The revision also contains: a minor correction to the
  123.    handling of the -O option; an adjustment to the conditions for
  124.    using d_namlen in the Linux dirent structure; and yet another
  125.    attempt to write "standard" SunOS/Solaris install and deinstall
  126.    Makefile rules.
  127.  
  128. See the 00DIST distribution file for more details on feature
  129. additions and bug fixes.  The 00README distribution file gives
  130. background and installation information.  The 00FAQ file contains
  131. a list of frequently asked questions and their answers.  The
  132. 00PORTING file contains information on porting lsof to other Unix
  133. dialects.  The distribution files lsof.8 (nroff source) and lsof.man
  134. (nroff formatted output) contain the manual page for lsof; it is
  135. the only other documentation besides the source code (it's included).
  136.  
  137.  
  138. Version 3 Binaries
  139. ==================
  140.  
  141. Version 3 binaries for some revisions, dialects, and platforms may
  142. be found in pub/tools/unix/lsof/binaries.  Check the README files
  143. for exact descriptions.  Check the dialect-specific Makefiles for
  144. installation instructions.  CHECKSUMS and PGP certificates are
  145. provided for authentication.
  146.  
  147. Please think very carefully before you decide to use a binary from
  148. this distribution instead of making your own from the sources.
  149. Here are some points to consider:
  150.  
  151. 1.  Lsof must run setgid or setuid.  Are you willing to trust
  152.     that power to a binary you didn't construct yourself?
  153.  
  154. 2.  Lsof binaries may be generated on a system whose configuration
  155.     header files differ from yours.  Under OSF/1, for example, lsof
  156.     includes header files from the machine's configuration directory,
  157.     /sys/<name>.  Are you willing to gamble that your configuration
  158.     directory's header files match the ones used to compile lsof?
  159.  
  160. 3.  Lsof is often configured with specific options that are
  161.     determined from the configuration of the system on which it is
  162.     configured -- e.g., DECnet for Ultrix, RxFS for DC/OSx, Solaris
  163.     patch level, Pyramid hardware architecture, dynamic loader
  164.     libraries, etc.  Are you sure that the lsof binary you retrieve
  165.     will have been configured for your system?  If you get a binary
  166.     that is misconfigured for you, it may not work at all.
  167.  
  168. If you haven't already guessed, I believe firmly that you should
  169. retrieve sources and build your own binary.  If you still want to
  170. use the distribution binaries, please authenticate what you retrieved
  171. with the PGP certificates; please compare checksums, too.
  172.  
  173.  
  174. Version 3 Checksums
  175. ===================
  176.  
  177. Security checksums -- both MD5 and sum(1) -- for revisions of lsof
  178. version 3 are contained in the README.lsof_<rev> files in the
  179. wrapper tar files of pub/tools/unix/lsof.
  180.  
  181.  
  182. PGP Certificates
  183. ================
  184.  
  185. The lsof source tar and binary files are accompanied by PGP
  186. certificates in files that have an "asc" extension.  The certificates
  187. are signed with my public key, which may be found in the file:
  188.  
  189.     pub/tools/unix/lsof/Victor_A_Abell.pgp
  190.  
  191. My key is also available via public key servers and the URL:
  192.  
  193.     http://www-rcd.cc.purdue.edu/abe/
  194.  
  195.  
  196. Lsof Version 2
  197. ==============
  198.  
  199. The version 3 predecessor, revision 36 of version 2, is also
  200. available in pub/tools/unix/lsof/OLD/lsof236tar.gz on vic.cc.purdue.edu.
  201. I recommend you avoid it.  It's out of date and I no longer provide
  202. support for it.  (Version 3 supports more dialects, and has many
  203. enhancements, bug fixes, and improvements.)  Version 2 supports
  204. the following Unix dialects.
  205.  
  206.     AIX 3.2.[1234]            IBM RISC/System 6000
  207.     EP/IX 1.4.3 and 2.1.1        CDC 4680
  208.     ETAV 1.17            ETA-10P*
  209.     FreeBSD 1.0e            Intel-based architecture
  210.     HP-UX [789].x            HP
  211.     IRIX 4.0.5 and 5.1.1        SGI
  212.     NEXTSTEP 2.1, 3.0, 3.1        NeXT
  213.     OSF/1 1.[23] and 2.0        DEC Alpha
  214.     Sequent Dynix 3.0.12        Sequent Symmetry
  215.     SunOS 4.1.[123]            Sun 3 and 4
  216.     SunOS 5.[13] (Solaris 2.[13])    Sun 4
  217.     Ultrix 2.2 and 4.2        DEC
  218.  
  219. (If you need a copy of gunzip, look for it at prep.ai.mit.edu in
  220. pub/gnu.)
  221.  
  222.  
  223. Version 2 Checksums
  224. ===================
  225.  
  226. MD5:
  227.     (OLD/lsof236tar.gz) = f8a1ab3971ea2f6a3ea16752f84409e8
  228.  
  229. sum(1):
  230.     39996   106 OLD/lsof236tar.gz
  231.  
  232. The file OLD/lsof236tar.gz.asc is a PGP certificate that may be used to
  233. authenticate OLD/lsof236tar.gz with my public key.  You may find my public
  234. key on vic.cc.purdue.edu in pub/tools/unix/lsof/Victor_A_Abell.pgp; via
  235. the URL http://www-rcd.cc.purdue.edu/abe/; or at public key servers.
  236.  
  237.  
  238. Vic Abell <abe@cc.purdue.edu>
  239. July 27, 1995
  240.